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[57] ABSTRACT 

An object oriented date and time control in a graphical user 
interface of a computer system is composed of a plurality of 
child objects, e.g., spin buttons. Changes to the children of 
the control are consolidated in a massaging mechanism 
which includes a message format including a contiol iden- 
tifier of the control and a name of the detected change. In this 
way, the owning application docs not have to monitor 
element of the control separately. Each child object has a 
range of allowed values which the user may select The diild 
objects interact such that a range of allowed values in one 
child object, the diild object which sets the day value, is set 
according to die value fa: another child object, the child 
object which sets tiie month value. Responsive to changes in 
the month value, the range of allowed values for the day 
value may change accordingly. Hie date and time control is 
sensitive to locale or country specific data. In response to a 
given locale for the owning application, die order of the day, 
month and year elements of the date control and the 12 hour 
or 24 hour modes of the time control may be set con^iat- 
ibility to the conventions of the given locale. 
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GRAPHICAL USER INTERFACE entering 25 hours in a day. Further, there arc many national 

INTERACTION BETWEEN TIME AND DATE language issues to be addressed when dealing with date and 

CONTROLS time, if an application will be internationally marketed. 

Hiese aad many other considerations must be taken into 

BACKGROUND OF THE INVENTION 5 account by every developer that needs to provide a date or 

a time fidd as part of a GUI Hence, a need clearly exists for 

The present invention relates generaUy to graphical com- controls which provide aU of these features, 
puter interfaces. More particularly, the invention relates to 

date and time controls in a grajdiical user interface allowing SUMMARY OF THE INVENTTON 

user input time and date values to be transmitted to an .p. 

appUcation progranL Therefore, it is an object of the invenUon to provide an 

AS users of computers have continued to transition from ^oved graphical user interface for inputting date and time 
highly skilled computer programmers to people from all 

levels of society, including those with relatively low skill another object of the invention to limit entry of 

levels, it has become necessary to improve the usabiUty of 15 inaccurate date and time data. 

a computer. Among the means employed to make a com- It is another object of the invention to reuse flic controls 

puter more "user Mendly" is a graphical user interface or for a variety of platforms with minimal recording effort 

**GUr'. As compared to command line interfaces wherdn it is another object of the invention to support interaa- 

end users must memorize complex and convoluted com- tionalization issues spedflc to particular countries, 

mands and command syntax to perform a given function, a 20 jhese and other objects are accomplished by a date and 

GUI provides manipulable graphical objects such as ^^^^ .^^ ^ g^iphical user interface of a computer 

windows, icons and various controls on the disf^ay screen. system, the control composed of a pluraUty of child 

Tliese grairfiical objects can be used in a more intuitive elements, e.g., spin buttons. User input to the diild dements 

manner to control the operation of the con^uto- system. ^ monitored. If a change is detected a message including a 

Well known graphical user interfaces include IBM's OS/2™ 25 control identifier of the control and a name of flic detected 

Operating System, die user of various operating systems for ^.j^^g^ ^ prepared to the application which owns the 

flie computers made by flie Apple Corporation and Microsoft ^^^^^^ ^^y^ ^^^^g appUcation docs not have to 

Vrlndows™. monitor elements of the control separately. 

The controls used in many known graphical user inter- -j^^ ^^^^^ preferably an object oriented control corn- 
faces (GUIs) are object based. ITiat is, the window controls 30 plurality of chfld objects. Eadi object has a range 
in a particular dialog window are chUd objects of the aUowed values which the user may select. The child 
window. Exanq)les of controls which aUow the user to ^^j^^ interact such that a range of allowed values in one 
interact wifli an application are entry fields, radio buttons, ^j^^^ ^^^^^ ^^ject which sets flie day value, is set 
checkboxes, and spin buttons. In OS/2, the Presentation according to the value for another child object, the diild 
Manager (PM) faciUty has provided flicsc and many other 35 ^^-^^ ^^^^ ^^^^ ^^^^ Responsive to changes in 
standard controls as graphical objects which developers can ^^^^ ^^^^ aUowed values for flie day 
use to bufld a GUI for tfieir appHcations. Presentation ^^^^ ^ accordingly. 

Manager is the underlying presentation interface in the OS/2 r«j^ -^^^ii^ *_ 

enviromnent for providing GUI related controls. Motif is tho ^he date and tmie control is sensitive to locale or comitry 

equivalent presentation interface in flie AIX enviromnent. 40 ^P^^i^^,^ '^'^T* V ^""^^^^ ^^f"? 

• 11 r-xTT 1 « rt^-. ^'^r^.^ apphcation, flie order of tfie day, monfli and year elements of 

Typically, any GUI ^^^^^ ^^^^^/,f^^^^^ ^ * nt?Z the date coiltrol andflie 12 hour or 24 hour nfodes of flie time 

envin>mi^nt build on ^P/ f^^ Jf^^^^ control may be set compatibiUty to flie conventions of flie 

mterfacetopnjvidemadditiond^ application Ly override the standard 

toepresentauon mterface whdeprovidmg^^^ ronventionsfliroughaprogramming interface of the control 

Uon and ease of applicaUon development The Worlq,lace 45 inappropriate for a particular application. 

Shell Programming Interface is one exan^le specific to flie " ucwucu uiap^ut/nat^ ya^^ uuu. aiii.iii^uuu. 

OS/2 environment of an object dass hierarchy fliat encap- BRIEF DESOUFIION OF THE DRAWINGS 
sulates some features of Rrescntation Manager, The Work- 
place Shell Programming Interface was developed in order These objects, features and advantages will be more 
to create flie OS/2 Worlqjlace Shell itself and is not available 50 readily understood wifli reference to flie attached figures and 
to be used independenfly from the OS/2 operating system. following description. 

However, some of its classes can be used to develop FIG. 1 depicts a computer system configured according to 

applications in the OS/2 environment, Oflier object class the teachings of flie present invention. 

libraries, such as IBm Open Class Library, provide GUI FIG. 2 depicts one preferred graphical interface according 

related control classes which are designed to interface with 55 teachings of flie present invention. 

multiple underlying presentation interfaces; hence, appUca- pj^g 3 diagrams of controlling user input 

tions developed using fliese classes can be easUy ported to ^^^^^^^ informatioo is 

any of the environments which the class library supports. accepted. 

However many applications need two c^^^^ FIG. 4is aflow diagram showing howflie date control is 

notpartoftiiehbranesavailabletotheOS/2dev^ 60 ..^^ered according to flie appropriate local 

and time controls. Currently, whenever an apphcation has a « j. I \^ *t. ^. ^ , 

need to display a date or time value in such a way ttiat flie ^ ^ '^"^"^ ^^^^^ 

user can change it, i.e. not just an ou^ut only field, flie FIG. 6 is a flow diagram of a notification of a change to 

developer must construct fliese fields from oflier controls the control to flie owner so fliat special processing may 

and provide all of the necessary functionality. For example, 65 occur. 

a user must not be allowed to enter dates that are not valid FIG. 7 depicts enabling and disabling flie date or time 
such as February 30, or times tfiat are not valid sudi as control as a separate entity. 
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DETAILED DESCRIFnON OF THE the hardware interface for the keyboard 12, the mouse 

PREFERRED EMBODIMENT controller 29 provides the hardware interface for mouse 13» 

_ the video controller 30 is the hardware interface for the 

The invention my be run on a vancty of computers or display 14, and the audio controUcr 31 is the hardware 
coUection of computers under a number of different oper- ^ interface for the spcafcas 15. An I/O controller 40 sudi as a 
ating systems. The computer could be» for example, a Token Ring Adapter enables communication over a network 
personal computer, a mini computer, mainframe computer or 45 to otiier similarly configured data processing systems, 
a computer running in a distributed network of other com- Qne of the preferred implementations of the invention is 
puters. Although the specific choice of conqjuter Is limited ^3 ^^xs of instructions 48-52 resident in the random access 
only by diskanddiskstoragerequiremcnts, computers in the memoxy 24 of one or more computer systems configured 
IBM PS/2 (TM) series of con^ters could be used in the generally as described above. UntU required by the corn- 
present invention. For additional information on IBM's PS/2 putcr system, the set of instructions may be stored in another 
scries of con^Hiters, the reader is referred to Technical computer memory, for example, in the hard disk drive 26, or 
Reference Manual Personal Systems/2 Model 50, 60 Sys- in a removable memory such as an optical disk for eventual 
tems IBM Corporation, Part No. 68X2224 Order Number use in the CD-ROM 32 or in a floppy disk for eventual use 
S68X-2224 and Technical Reference 2 Manual Personal in the floppy disk drive 27. One skilled in the art would 
Systems/2 Model 80) IBM Corporation Part No, 68X 2256 appreciate that the frfiysical storage of the sets of instructions 
Order Number S68X-2254. One operating system which an physically changes the medium upon which it is stored 
IBM PS/2 personal conq>utcr may ran is IBM's OS/2 2.0 electricaUy, magnetically, or chemicaUy so fliat the medium 
CTM) for more infcmiation on the IBM OS/2 2.0 Operating ^ ""^"^^ computff readable mformation. 
System the reader is referi:ed to OSa 2.0 Technical Ubrary, Whflc it is convement to descnbe the mvention m terms 
Programming Guide Vol 1, 2, 3 Version 2.00 Order Nos. instnictions symbols characters, or the to, the reader 
1 n/^o/; 1 1 /vTi^o^ 1 nr^Qi. should remember that all of these and similar terms should 
lUOO^i, iyO04y:>, luoo^y*. . ^ ^ . be associated with the appropriate physical elements. 

In the alternative, the computer system might be in the p^jither, the invention is often described in terms of selecting 

IBM RISC Systcm/6000 (TM) Hnc of computers which run ^5 or validating, or other terms that could be associated with a 

on the ADC (TM) operating system. The various models of human operator. No action by a human operator is desirable 

the RISC System/6000 is described in many publications of in any of the operations described herein which form part of 

the IBM Corporation for example, RISC System/6000i KflS the present invention; the operations are machine operations 

and 7016 POWERstation and POWERserver Hardware processing electrical signals to generate other electrical 

Technical reference, Order No. SA23-2644-00. The ADC 3^ signals. 

operating system is described in General Concepts and The GUI Time and Date controls of the present invention 

Procedure— ASX Version 3 for RISC System/6000 Order gj-e preferably implemented as C++ classes using the IBM 

No. SC23-2202-00 as wdi as other publications of the IBM Qp^n Qass Libraries, so that they can be reused on multiple 

Corporation. platforms such as OS/2, ADC, and any future platforms that 

In no. 1, a oonq>uter 10, comprising a system unit U, a 35 the Open Class Libraries support Additionally, the controls 

keyboard 12, a mouse 13 and a display 14 are depicted in are designed to fully suppcot internationalization through the 

block diagram form. The system unit 11 includes a system use of XPG/4 compliant APIs. The User Interface Class 

bus or plurality of system buses 21 to which various com- Library is one of the libraries included in the IBM Open 

ponents are coupled and by which communication between Qass library. This is a publicly available offering from IBM. 

die various con4X>nents is accomplished. The microproccs- 40 it is cuirentiy available as part of the IBM VisualAge C++ 

sor 22 is connected to the system bus 21 and is supported by for OS/2 3.0 product The classes contained in this library 

read only memory (ROM) 23 and random access memory are documented in the following publication: IBM Visu- 

(RAM) 24 also connected to system bus 21. A micropro- alAge C++ for OS/2 3.0 Open Qass Library Reference, 

ccssor in the IBM compatible computers is one of the Intel Vols. 1-3 Order Nos. S25H-6965-00, S25H-69664)0, and 

family of microprocessors including the 386, 486 or Pen- 45 S25H-7031-00. The present invention is contemplated for 

tium (TM) miaoprocessors. However, other microproces- inclusion in a dass library or other GUI building tool so that 

sors including, but not limited to, Motorola's family of application developers may utilize it in their applications, 

microprocessors such as the 680(X), 68020 or the 68030 as shown in FIG. 2, window 100 contains both date 

microprocessors and various Reduced Instruction Set Com- control 101 and time control 103. The date control consists 

puter (RISC) microprocessors such as the PowerPC chip 50 of three spin buttons 105, 107, 109, eadi with its own spin 

manufactured by IBM, or others by Hewlett Packard, Sun, button arrows 111 so that users can easily adjust the values. 

MotoroU may be used in tiie specific conaputa. xhe month spin button 105 will only accept values 1-12. 

The ROM 23 contains among other code the Basic The day spin button 107 will accept only those values that 

Input-Output system (BIOS) which controls basic hardware are accurate for each given month. For examfde, if the month 

operations such as the interaction and the disk drives and the 53 spin button 103 is currently set to 2(February), the day spin 

keyboard. The RAM 24 is the main memory into which the button 107 will not accept values higher than 28, if it is not 

operating system and application programs arc loaded. The a leap year. If the year spin button 109 is set to a year that 

memory management chip 25 is connected to the system bus is a leap year, the day spin button 107 will allow 29 days in 

21 and controls direct memory access operations including, Fcbmary. The year spin button 109 accepts any values from 

passing data between the RAM 24 and hard disk drive 26 60 0-9999. Four digits were used because of the imminent turn 

and floppy disk drive 27. The CD ROM 32 also coupled to of the century. Above each spin button, the appropriate 

the system bus 21 is used to store a large amount of data, language equivalent of "Month", "Day", and "Year** labels 

e.g., a multimedia program or presentation. will indicate what each spin button represents. One skilled 

Also connected to this system bus 21 are various I/O in the art would appreciate that other controls such as empty 

controllers: The keyboard controller 28, the mouse control- 65 fields or drop down selection fields might be used as 

ler 29, the video controller 30, and the audio controller 31. components for other controls. These values are fully 

As might be expected, the keyboard controller 28 provides translatable. 
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The order of spin buttons will be detennined by the child object can be derived from multiple parents, inheriting 

f^iopriate language locale. In the preferred embodiment, methods from multiple parent objects. The undesired mcth- 

thc ^propriate language locale is supported compatibly to ods in the parent objects can be ovemdden in derivation 

the XPG/4 standard for internationalization APIs. The process acating the child object In addition, a child dass 

XPG/4 standard is an X/Opcn standard and is documented in 5 can define new methods of its owa The process of creating 

XPG/4 CAE Specification a publication of the X/Open a new child dass from a parent class is also called dass 

which is hereby incorporated by reference. For exan^le, derivation or subdassii^. All of these procedures are well 

some countries prefer dates to be expressed in a Day, Month, known to those skilled in object oriented programming. 

Year sequence, or a Year, Month, Day sequence, rather than The IBM Open Oass Library consists of several C++ 

the English American format, Month, Day, Year These dass h*braries which can be used in developing applications, 

variations will all be supported automatically based on Some of the classes contained in these dass libraries can be 

locale, and additionally, can be set through a public interface modified to provide some of the function of the present 

to the control In the preferred embodiment, the date order invention. Altcmativdy, those skilled in the art can build 

is set at initialization of the control, based on locale infer- their own objects from scratch with the noethods described 

marion if available. In the absence of locale information, the below. In the preferred embodiment, IMultiCellCanvas class 

date order defaults to Month, Day, Year. However, a public of the User Interface Class library was chosen as a parent 

programming interface is provided, such that the date order class for both the date and time controls. This parent dass, 

can be set programmatically to any of the three date formats. IMultiCellCanvas , provides many of the features helpful in 

This allows the application greater flexibility in the event creating date and time controls. One of the most attractive 

that the format dictated by the locale is not appropriate for ^ features of the mnlticcllcanvas is the ability to provide a 

the current application or locale information does not exist "canvas" which can be divided into cells, such that the 

on a given system. corr^oncnts of the controls can be nicdy formatted into 

Other public interfaces of this new date control class as rows and colunms. Another feature of the roultloellcanvas is 

explained below include the ability to programmatically set the ability to automatically resize all of its child windows 

tiie control to any valid date, the ability to retrieve the 25 proportionally whenever the canvas is resized. This property 

current value of the date from the control, the ability to is not essential for the invention; one skilled in the art would 

format the value of the date into a culturally correct string, appredate that an automatic resize method can be added to 

i.e. /mm/dd/yy, and the ability to enable and disable the the spin button object a: the spin button object may not be 

control as a single entity, capable of being resized. 

The time control 103 also consists of three spin buttons 30 Since the spin button objects have no inhaent relationship 

113, 115, 117 each with its own spin button arrows 111 so to each other even within a single canvas object, a series of 

tiiat users can easily adjust the values. This control 103 methods were devdc^d to control the values of the spin 

supports both 24 and 12-Hour time formats. In a prcfcared buttons such that unrealistic values would not be displayed, 

embodiment, the format defaults automatically to the appro- The User Interface Class Library provides general purpose 

priatc format based on the appropriate language locale as 35 spin and edit handler objects which can be subclassed for 

supported by the XPG 4 internationalization APIs. thispuipose. A spin handler, for exan^)le, can be attached to 

Additionally, as explained below, tiie time format (24 vs. 12) a spin button, such that whenever a diange to the spin button 

can be set programmatically through a public interface to the occurs, a method is invoked giving die application a chance 

dass. If 24-Hour format is desired, the hour spin button will to inspect and manipulate the values ^propriately. 

accept values from 0-23. If 12-Hour fcamat is desired, the 40 In the preferred embodiment of the invention, a new spin 

hour spin button wiU accept values from 1-12. In the handler dass was created by subdassing an existing spin 

12-Hour format, two radio buttons are provided which allow handler class available in the User Interface Qass Library, 

selection of AM or PM. Similar to the date control 101 This parent dass, BpinHandler, allows methods to be 

described above, above each spin button the appropriate invoked whenever a spin button is incremented or decre- 

language equivalent of Hours, Minutes, and Seconds labels 45 mented. In the absence of the preferred embodiment, one 

will indicate what each spin button represents. All values, skilled in the art could provide this functionality from 

induding the AM and PM strings, are flilly translatable. scratch, however, the new spin handler class aeated for 

Language translation of software typically involves a two purposes of this invention should provide for the following 

step process. First, the software itself is "enabled" for conditions as detailed in FIGS. 3A-D and described bdow. 

translation, whidi means that all text strings needed by the 50 Referring now to FIQ. 3A, the process starts, step 200. In 

application are stored (typically in a file) externally to the step 201, the control is initialized according to the standard 

^plication. These files typically have each text string iden- practices for object creation in the given object system, in 

tified by a non-translatable label widi which the application this case C-H- via the class constructor. In st^ 203, the 

references the text string. Second, the files containing the control is monitored for user interaction by means of a 

text strings are sent to a translation center where languages monitoring method. That is, when a user pushes one of the 

translators translate each text string (which in the US is in arrows of a given spin button, the event causes a method to 

English) into the appropriate languages in which the soft- be invoked If desired, upon receipt of an event, the appli- 

ware will be si^ported. cation devdoper may dect to invoke additional processing. 

As mentioned above, an object based approach is the Presuming this is true, in step 205, a test is paformed to 

preferred embodiment of the invention. IBM System Object 60 determine whether the month spin button was changed. If 

Model (SOM), the Worlqilace Shell Programming Interface, the month spin button is changed, a new method should be 

and IBM Open Class are all examples of object oriented invoked, MonthChanged, illustrated here as step 207 and in 

dass hierarchies from which graphical user interfaces can be greater detail in FIG. 3B. Next, in step 209, a test determines 

developed. The IBM Open Qass library, a collection of whether the day spin button is changed. If so, the Day- 

C++ class libraries, allows for a chUd object to "inherit" the 65 Changed method is invoked in step 211, illustrated greater 

methods of a parent object. This is true of many object biased detail in FIG. 3C. In tiie case of a change to the year spin 

systems. In C-H-, multiple inheritance is possible; that is, a button, the preferred emtx>diment condudes that no spedal 
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{vocessing is Decessary, stq> 213, and returns to raonltcrlng would be mq)lemented in conjunction with the optional year 

the control for user interaction. adjustment for month changes described above. 

FIG. 3B fllustrates the MonthChanged method. After FIG. 3D is a flow diagram of a method for detcnnining the 

invocaUon, step 250, the current value of the month spin- number of days in the month. The process begins with 
buttonisdctcnnined, step 251, In theprcfcrred embodiment, 5 invocation step 350 In 351, the value o^^ 

the spin button dass has a method which wlU return its a year, Y, is i^ut Step 353 determmts 

cutxentvalu.Ne..ins^253.^ ^^^^JV^^^^ 

current montti must be obtained The preferred einbodiment ^si^tcrmin^ whetlir the value of M equals 2. If not^ step 

makesuscof amrthodfor calcd^^ 35j> ^ ^ ^^^l 3j jjoweven 

by a class, IDate, mcluded m IBM Open Class. The mediod, lO ^ ^^^^ ^ ^^^^ ^^^^^ necessary. If the 

daysInMonth, returns the number of days m a given month, remainder of Y when divided by 400 is 0, step 361, then the 

in a given year. This method accurately accounts for leap number of days in the month is set to 29, step 363. If not the 

years, as wclL In the absence of this method, one skilled in test in step 365 determines if the remainder of Y when 

the art can provide a similar method using a method similar divided by 4 is equal to 0. If not, in step 367, the number of 
to that detailed in FIG. 3D. ^ month is set to 28. Otherwise, the test in step 369 

Once the number of days in the month is determined, the finds if the remainder of Y when divided by 100 is 0. If not, 

value of the day spin button must be obtained in step 255, then step 371 sets the number of days in the month is 28. If 

In the object oriented preferred embodiment, each spin so, the number of days in the month is 29. In step 375, the 

button should have a method which returns its current value. ^^^^^ days in the month is returned to the owning 

In stq) 257, a test is performed to determine if ttie value of process. 

the day spin button is now greater thaij the number of days time control docs not require the same type of 

in the current month. If so, in step 259, the value of the day interartion among the spin buttons as the date control, 

spin button is set to the numbo: of days in the current month. Therefore, although spm handlers could be used between the 
In step 261, the range of values that the day spin button can buttons which compose the tune con^ol, in the pre^ 

nowacceptissetfromltothenumberofdaysinthecurrent ^5 feired embodmient, they were not used for the time control, 
month. Id the preferred embodiment the spin button should IntemationalizatioD 
provide a method for setting its range of values. Thus, the ^^^-^^ ^ invention is to provide support 

user is prevented from spinmng the control to a day value internationalization and country specific locale infbrma- 

that IS mvahd. successfully sell software in an international market, 

The process flow continues to step 263, for further pro- n jg necessary to provide software to the usct in the language 

cessing such that the year value can be adjusted in re^onsc of their choice. In the preferred embodiment, the time and 

to certain user changes in the month. A test in step 263, (Jate controls satisfy this requirement by allowing all text 

determines if the month spin button is incremented. If so, labels to be set, i.e. translated, externally to the controls. The 

and the new value equals 1, in the test in step 265, the year individual components of the date and time contrx)l5, the spin 

is incremented by 1 in step 267. If the month spin button is buttons will also order themselves according to the conven- 

decremented, and the new value equals 12 in the test in step tions of the particular locale selected, lined up with its 

269, the year is deacmcntcd year by 1 in step 271. The corresponding translated label. 

processing in steps 263-271 have aUowed the user to *tlq>" j^q methods are provided for setting the labels of the 
through dates by scroUing the month value. Alternatively, ^ ^ ^j^^ controls. One method uses a set of functions 
such processing may be omitted, in which case changes to defined to accept character strings and which are 

the month would have no effect on the value of the year spin be used prograimnatically. When using these functions, 
button. The process returns, step 273. appUcation developer is responsible for locating and 

La addition to monitoring the control for month changes, providing (he character strings. Hie second method utilizes 
the control can be monitored for changes to the day spin 45 a second set of functions which are defined to accept 

button as well. This processing is optional since, as detailed instances, i.e. objects, of the IResourceld Class of the User 

above, the range of valid values for the day spin button is interface Qass Library. Instances of the IResourceld class 

adjusted every time that the month spin button is changed, allow text strings to be indexed by a resource id from a 

which ensures its validity. However, just as the year can be resource file that exists external to the application code. The 
adjusted for certain month changes, so too can the month so resource file typically contains all of the translatable text of 

value be adjusted for certain day changes. As illustrated in an application. A different resource file usually exists for 

FIG. 3C, if the day spin button is changed, a new method can each language supported by the implication. The instance of 

be invoked, DayChanged. IResourceld identifies both the resource id of the character 

After invocation, step 300, the value of the day spin string and the resource file in which it located. Functions of 
button is determined in step 301, A test in step 303 deter- 55 the IResourceld instance perform the reading of the string 

mines ifthe day spin button is incremented. Ifso, and the test from the file. Finally, if no labeb are provided by the 

in step 305 determines that the new value equals 1, step 307 application developer, the date and time control defaults to 

increments the month spin button by 1. If the day spin button English labels for the spin buttons, 
is decremented, step 309 obtains the upper bound of the day In the preferred embodiment, the IResourceld Class 
spin button range. As discussed above, the spin button objea 60 retrieves country specific daU according to the XPG/4 

should preferably provide a method for obtaining the upper Internationalization APIs. The XPQ/4 APIs provide date and 

bound of its range. If the test in step 311 determines that the time formatting infOTmation based on country and language 

value of the day spin button equals the upper b<Hind of its specific locale information. Those skilled in the art would 

range, step 313 decrements the value of the month spin recognize that other databases and means could provide 
button by i. The DayChanged method ends in step 314. The 65 country specific information. For example, the use of coun- 

DayChanged method allows the user to ^'flip'* tlirough dates try codes for a specific version of an application is one 

by saoUing the value of the day spin button. Ideally, this alternative. 
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Many operatiiig systems provide limited intonatioiializa- 
tion capabilities. For example, OS/2 provides such capabili- 
ties based on country code page or keyboard parameters 
defined in the CONHG. SYS file or CONHG. INI files. In 
OS/2, these parameters are used for all applications running 
on the OS/2 workstation. To change country spcdfic data, a 
system reboot is required. While this level of support is 
adequate for many US users who rarely, if ever, change the 
country data on their workstation, it is not adequate in 
certain Europe and Asian markets where the user may wish 
to change the parameters for different programs easily and 
quickly as the system is running. Thus, some embodiments 
of the invention allow user input to change the order, format 
and labels of the controls. Application developers would 
prefer that only a single version of their application be 
written rather than writing a separate version fOT each 
country. It is also desirable that new countries and keyboard 
layouts may be added to the system as the application 
program gains in popularity in new countries. The XPG/4 
internationalization model consists of a set of APIs, com- 
mands and Locale.dlls. IBM has written a tool kit fca: OS/2 
which it has made available to application developers. 
XPG/4 support is also found in IBM's ABC operating 
system. 

The XPG/4 model is based on Locales, whatan Ae world 
is divided into a collection of Locales. A given country may 
have one or more Locales assigned to it depending upon its 
cultural diversity. A Locale is comprised of a combination of 
language and monetary, time and diaracter sorting conven- 
tions for a particular country. For example, Switzerland has 
German, Italian and Flrendi Locales, AH of the Swiss locales 
support the same country, date, time and monetary 
standards, but each has distinct and cultural conventions fca: 
alphabet sorting and messages. 

Locale names can be specified in a command for example, 
set LANG=xx yy.zzzz. wherein xx is a language 
abbreviation, yy is a country abbreviation and .zzzz is an 
optional three or four digit code page number. To set the 
Locale to US English one might type: set LANG=EN_US. 
437. Those skilled in the art would realize that other formats 
and nicknames mi^t be used to set the Locale variable. The 
acmal Locale information may be stored in dynamic link 
libraries of odier suitable data structures. 

Also included in the developer tool kit are include files, 
iibraries.dlls and programs necessary for using the XPG/4 in 
an application program. 

An international program generally changes a default 
Locale for a Locale set by the user by a caU to SET 
LOCALE which determines the programs Locale by the 
LAN environment variable or a call ovcniding whose spe- 
cific environmental variables or messages monetary 
formatting, date and time formatting and so forth. 

The XPG/4 library comes in two parts, an import library 
which is linked to the aj^licatlon and a dynamic link library 
whidi is placed in the runtime machines bypath. 

National language support is described in the XPG/4 CAE 
specification which is a publication of the X/Open Con^sany 
Ltd. 

The country specific information, if available on a given 
system, is queried by the time and date controls through the 
use of the XPG/4 APIs. One of die APIs provided with 
XPG/4 support, id^Janginfo, returns data pertaining to the 
language aspects of the locale. In this case, the date format 
can be determined by calling the nLJanginfo API with the 
D_JMT parameter. This returns a diaracter string in the 
format correct for the current locale, for example mm/dd/yy, 
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dd/mm/yy, or yy/mm/dd. The time cmode of 24 verses 12 
hour format can also be obtained from the nl_langinfo API 
by calling it with the AM_5TR or PM_STR parameters . In 
this case a null character string returned dictates a 24 hour 

5 time format, otherwise the format is 12 hour. In response to 
this information, the controls may be modified as follows: 
Date Order The Date Control can display the date in the 
Month, Day, Year format, the Day, Month, Year format, or 
the Year, Month, Day format. The order of spinbuttons is set 
by manipulating the column in which a position value for 
each spin button object appears in a table kept by the parent 
multicellcanvas object. For exan^le, if die date format as 
indicated by the locale is the Month, Day, Year farmat, the 
month spin button and its corresponding text label are added 
to the multiceUcanvas in the leftmost column, next followed 
by the day spin button and its label in the next column, 
finally followed by the year spin button and its label. The 
spin button objects are therefore added to the multicellcan- 
vas object in whatever order is correct for the locale. 
The Date order process is depicted in FIG. 4 and dis- 

20 cussed iQ greater detail immediately below. 

The process begins in step 400. In step 401, die date order, 
D, is Input to the process. Given a desired date order, D, as 
input two tests, steps 407 and 421, are parfonned to deter- 
mine the branch of the process to use. Logically, the date 

25 order can consist (rf one of three values: 

1. Day, Month, Year (DMY) 

2. Year, Month, Day O^MD) 

3. Month, Day, Year (MDY) 

First, howeva, st^ 403 determines if this is the initial pass 

30 through this processing. If it is not, step 405 removes the 
previous contents of all the ceUs of the multicellcanvas so 
that new values can be placed in dicm. Hie row and column 
characteristics of the multicellcanvas aUow the control to 
change the date order efBciently. Hcrwevcr, while one skilled 

35 in the art can appreciate the benefits of having such a tabular 
canvas for this purpose, other alternatives such as creation of 
a multidimensiond array structure would be possible. 

Next, step 407 tests if the date order, D, equals DMY, If 
so, then steps 409-419 are performed. In step 409, the text 

40 label corresponding to the day spin button to the cell that 
resides in row 1, column 1 of the canvas is added to the 
control In step 411, the day spin button to the oeU that 
resides in row 2, colunm 1 of the canvas is added. The text 
label cotresponding to the month spin button to the cell that 

45 resides in row 1, column 2 of the canvas is added in step 413. 
The month spin button to the cell which resides in row 2, 
colunon 2 of the canvas is added in step 415. Step 417 adds 
the text label corresponding to the year spin button to the cell 
that resides in row 1, column 3 of the canvas. Step 419 adds 

50 the year spin button to the ceU that resides in row 2, column 
3 of the canvas. The labels are retrieved firom instance data 
stored in the class at initialiiation of the control. 

However, if the date order does not equal DMY, the test 
in step 421 determines if date order, D, equals YMD. If so, 

55 then steps 423-433 are performed. Step 423 adds the text 
label corresponding,to the year spin button to the cell that 
resides in row 1, column 1 of the canvas. The year spin 
button to the cell that resides in row 2, column 1 of the 
canvas is added in stqp 425. In step 427, the text label 

60 corresponding to the month spin button to the cell that 
resides in row 1, column 2 of the canvas. Step 429 adds the 
month spin button to the cell which resides in row 2, column 
2 of the canvas. The text label corresponding to the day spin 
button to the cell that resides in row 1, column 3 of the 

65 canvas is added in step 431. In step 433, the day spin button 
to the cell that resides in row 2, column 3 of die canvas is 
added. 
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If the date order is not DMY or YMD, the proces s defaults 
to MDY processing. In step 435, the text label corresponding 
to the month spin button to the cell that resides in row 1^ 
column 1 of the canvas is added. Step 437 add the month 
spin button to the cell which resides in row 2, column 1 of 5 
the canvas. The text label conresponding to the day spin 
button to the cell that resides in row 1, column 2 of the 
canvas is added in step 439. The day spin button to the cell 
whid) resides in row 2, column 2 of the canvas is added in 
step 441. Step 443 adds the text label coiresponding to the 
year spin button to the cell that resides in row 1 column 3 of 
the canvas. In step 445, the year spin button to the cell that 
resides in row 2, column 3 of the canvas is added. 

Once the day order is set in the canvas, step 447 sets an 
instance variable to indicate the current date order, fcr 
example, 

usDateQrder=0 (this would indicate MDY format) 
usDatcOrder^l (this would indicate DMY format) 
usDateOrder=2 (this would indicate YMD format). 
The process returns, step 449. 20 

In addition, a method can be invoked to set the date order 
independently of the locale by using the public interfaces of 
the preferred embodiment described below. 

Time Mode: The time control can display the time in 24 
or 12 hour format. Similar to the date format above, the time 25 
mode can be dictated by the locale, or set independently. For 
the 24 hour format, the range of valid entries to the hour spin 
button is set to Q-23. The time control object is set to consist 
three spinbuttons with no radio buttons. For the 12 hour 
format, the range of the hour spin button is set to 1-12. As 30 
shown above* the preferred embodiment of the time control 
comprises three spin buttons and two radio buttons for AM 
andPM. 

An existing dass object, such as the ITime class of the 
User Interface Qass library can be used as the time con- 35 
struct for retrieving and setting the value of the time control 
programmatically. Alternatively, the function can be built 
ioto the time control object itself. One skilled in the art could 
likewise provide a similar construct which consists of a 
conmion programming structure having three unsigned short 40 
integer values which together represent a time value. For the 
24 hour format, the output of the Illme class can be used 
without manipulation. However, for the 12 hour format, 
further processing is necessary since the mme dass stares 
data in 24 hour format. 45 

The process for setting the time control object in 12 hour 
format progranmiatically given time in 24 hour format is 
depicted in FIG. 5. After initiating the process, step 500, in 
step 501, a test is performed to dctciminc whether the 
number of hours in the ITime construct is equal to 12. If so, 50 
in step 503, set the hours spin button to 12, and set the FM 
radiobutton to be "selected". If the number of hours in the 
nime construct is not equal to 12, in step 505, a test is 
performed to determine if the number of hours in the ITime 
construct is equal to 0. If so, in step 507, the hours spin 55 
button is set to 12, and the AM radiobutton is set to 
"selected'*. 

If the test in step 505 fails, then a test in step 509 
determines if the number of hours in the TTime construct is 
greater than 12. If so, in step 511 set the hours spin button 60 
to the number of hours minus 12, and set the FM radiobutton 
to be "selected**. If the test in st^ 509 fails, Le. the number 
of hours is less than 12, in step 513 set the hours spin button 
to the number of hours in the Tllme construct, and set the 
AM radiobutton to be *'sdected**. 65 

The process for retrieving the time from the time control 
programmatically is basically the reverse of the process of 
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querying the value of the Hours Spinbutton and the radio 
buttons for conversion into the 24 hour fOTmat acceptable to 
the rnme construct. The process (not illustrated) is as 
follows: First, the value from the minutes spin button is 
retrieved. Next, the value from the seconds spin button is 
determined. Next, the value from the hours spin button is 
retrieved. As discussed above, each spin button should have 
a method for returning its current value. Next, the current 
time mode (24 vctsus 12) is determined by querying the 
value of an instance variable created for this purpose. If the 
time mode is 24 hour format, the value of the hours spin 
button is already in the correct format so no special pro- 
cessing is necessary. 

However, if the time mode is 12 hour fOTmat, the follow- 
ing process is performed. If the value of the hours spin 
button equals 12, and the AM radio button is selected, Aen 
the equivalent number of hours in 24 hour format is equal to 
0. Otherwise, if the value of the hours spin button equals 12, 
and the PM radio button is selected, then the equivalent 
number of hours in 24 hour format is equal to 12. OUierwise, 
if the value of the hours spin button does not equal 12, and 
the PM radio button is sdcctcd, then the equivalent number 
of hours in 24 hour format is equal to the value of the hours 
spin button plus 12, Otherwise, if flie value of the hours spin 
button does not equal 12, and the AM radio button is 
selected, then the equivalent number of hours in 24 hour 
format is equal to the value of the hours spin button. Finally, 
the ITime construct, or a similar structure, can be set with the 
correct number of hours, minutes, and seconds in 24 hour 
foraiat, regardless of the current format of the time controL 

Other public interfaces of the time control dass object, as 
shown in greater detail below, include the ability to pro- 
grammaticaUy set the control to any valid time, the ability to 
retrieve the current value of the time from the control, the 
ability to format the value of the time into a culturally 
correct string, and the ability to enable and disable &c 
control as a single entity. 

Event Notification 

Another unique feature of the date and time controls of the 
present invention is the ability to send notification that a 
change occurred from the control to its owner window or 
application. Through the use of the Open Oass library 
handler functions, a handler dass has been in^lemented 
whidi applications can use if they wish to be notified when 
the new event, UIFW_J3T_CHANGED, has occurred. This 
gives the application the opportunity to perform spedal 
processing based on this event, sudi as querying and saving 
data. O&ers might indude saving the new values to disk or 
sending them to other applications. Yet another exan^le of 
special processing would be for other GUI controls to update 
their values automatically based on changes to the date and 
time control For example, the application might update the 
time control in response to changes in the date control. 

Event processing by the date and time controls is unique 
because it is generated from the control itself, rather than the 
individual components of the control, such as the spin 
buttons. For example, when a user increments a spin button 
to change the time, and the application wishes to be notified, 
an event will be generated indicating that a time change has 
occurred. Without this handler, the application would have 
to listen for events directly from each spin button and then 
determine which control contained the spin button. 

Communication among the GUI conqionents of the con- 
trols can be implemented as a series of messages which are 
sent to and from controls and windows within the GUI to 
signify that various events are taking place. In the preferred 
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embodiment, the fact that the value of cither the date or time 
control has changed is an event of whic^ the owning window 
of the control should be. notified. The process by which the 
control issues the event notification is depicted in FIG. 6 and 
described below. 

After initiating the notificatioa process, step 600, the 
control is monitored for user interaction by means of an edit 
handler which is attached to the control during control 
initialization, stop 601. In the preferred embodiment, the edit 
handler can be constructed by subclassing a general purpose 
edit handler class contained in IBM Open Class called 
lEditHandler. The purpose of such a dass is to listen for edit 
events of a given control and invoke a method, the edit 
mediod, when such an event occurs. In the prcfaxcd 
embodiment of this invention, the edit method was override 
den in the subclass to process these individual edit events. 
Ihe "edit events" in the date and time controls are any 
changes to the individual spin buttons of the controls. 

If any change within the control occurs, step 603, the edit 
method is invoiced, and the following processing occurs. In 
step 60S, the control identifier is obtained from the control. 
As mentioned previously, all controls, date and time 
included, are assigned an arbitraiy control identifier at the 
time the control is constructed. In step 607, the event 
structure for the new event is aeated. This event structure 
consists of the identifier of the control that is sending the 
event, the event name, in this case UIFW_DT_ 
CHANGED, and the window handle of the control that is 
sending the event In step 609, a pointer to the owna of the 
control is obtained. In the preferred embodiment, a method 
is provided by an ancestor class, IWindow, which is avail- 
able to the controls and provides this information. In step 
611, the event is sent to the owner window. In the preferred 
embodiment, this is accoix^lished by means of another 
method provided by the ancestor dass IWindow, sendEvent 
This method takes as its input the event structure to be sent, 
and relies on the underlying presentation layer to send the 
event as a message to the receiver object, in this case the 
owner window. Presentation layers, such as Presentation 
Manager in OS/2, commonly coordinate communication 



of its disabled status. It is thus inaportant that a control has 
the ability to be disabled and correspondingly enabled. 

In the preferred embodiment, as child objects of the 
IMultiCellCanvas class, the date and time controls have 
access to methods provided not only by their immediate 
parent objects, but also by all their previous ancestor objects 
at higher levels in the object hierarchy. Two methods, 
enablcO and disableQ were available from a more generic 
parent object, IWindow. The IWindow dass is the parent of 
many classes in the User Interface Qass Library and as such 
provides some basic functionality to all control objects 
beneath it in the object hierarchy. Since spin buttons and text 
fidds are both children of IWindow in the prefened 
embodiment, these objects inherit some basic methods to be 
enabled and disabled. However, in the new date and time 
controls, to respond appropriately to being enabled or dis- 
abled it was necessary to override the generic disableQ and 
enableO methods inherited by the controls. Id C++, a method 
inherited from a parent can be overridden by declaring the 
method in the class definition. Hie application can then 
provide new functionality with will take precedence over the 
method of the same name provided by the parent For 
example, in the disable() method of the date control, the 
month, day, and year spin buttons are each sent the message 
to disable themsdves. Hie same is true for the correspond- 
25 ing text labds. The result is that the entire date control is 
disabled as a single entity. 

The process of disabling the Date control as a single entity 
is dq)ictcd in FIG. 7. After invocation of the method in step 
700, in Step 701, the parent disable() method is called. It is 
common to call the parent method when ovenidding meth- 
ods to take advantage of an processing the parent method 
does. In this case, caUing the parent method serves to disable 
the multicdlcanvas that comprises the date controL All 
con^nents of the date control are descendents of the 
IWindow class and have overridden disableQ methods of 
their own. This means that each spin button and each text 
label has access to its own disableQ method. 

In the steps 703-713 the disableQ method is m turn called 
on each component of the control as follows: In Step 703, 



10 



15 



20 



30 



35 



among its windows through messages. Those skilled in the ^ the disableQ method is called for the Month spin button, 
art would readily appreciate that alternative massaging This grays out and othawise disables, i.e. disallows user 
mechanisms can be used. 

In the preferred embodiment, the time control in 12 horn- 
format requires an additional handler to monitor the selec- 
tion of the radio buttons. This handler is similar to the edit 



input or other changes, the Month spin button. In Step 705, 
the disableQ method is called for the Day spin button. This 
grays out the otherwise disables the Day spin button. In step 
707, the disableQ method is called for the Year spin buttorL 



handler, cxc.pt that it is derived from the ISdecfflandle. 3^»flK' ^it^^'!fK^^t"r,.^f.^^^ 



dass of the IBM Open Gass library, and monitors "select** 
events instead of "edit** events. One skilled in the art would 
recognize that other controls which rdy on selection events 
rather than edit events would perform similarly. 



In Stq> 709, the disableQ method is called for the Month text 
label. This grays out and otherwise disables the Month text 
labd. In Step 711, the disableQ method is called for the Day 
text labeL This grays out and otherwise disables the Day text 



. .t...u \: ^1- 50 label In Step 713, the disableQ method is called for the Year 

Hie result is that the date or tmic control issues an event ^^^^ ^nd odicrwisc disables the Year text 

label The process ends, step 715. 



notification to its owner whenever a change occurs within it 
Furthermore, this event notification references the id of the 
control itself, instead of an individual object within the 
control. 

The section above describes how the control issues the 
event notification. A section below describes how an appli- 
cation can use the new handler class, 
UIFWDateTimeHandler, to listen for notification of this new 
event 

Enabling and Disabling the Controls 

At times, it is necessary for a GUI control to be disabled 
so that the user is unable to interact with the control at that 
time. Perhaps the user is not authorized to change the field 
or the data contained within the Add is not applicable, given 
the current values of other fidds in the GUL A disabled field 
also should be visually "grayed out" so that the user is aware 



The result is that the entire date control J5)pears grayed out 
and does not respond to user interaction. Those skilled in the 
55 art would understand that the enable method is similar. 

Portability Across Platforms 

As mentioned above, one of the objects of the inventions 
was to promote portability across multiple platforms. In the 

^ preferred embodiment, the IBM User Interface Class 
Library was diosen as the development dass structure 
because its classes are designed to be platf(»m independent 
Currently, this class library is in use in both the OS/2 and 
AIX environments. In addition to using this portable devel- 

65 opraent tod, care was taken to not introduce any platform 
specific code into the date and time controls . The result is a 
pair of controls that can be used in . any environment that 
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supports the Open Class Library. Those skilled in the art 
would readily comprehend that other class libraries could be 
used as a basis for the time and date controls such as 2^pp 
Portable C++ Application Framework from Inmark Devel- 
opment Corp.* Zinc Application Framework from Zinc Soft- 
ware Inc., and C++ Libraries for Containers and More from 
Rogue Wave Software, Inc. 

Interfaces for Programmatic Setting of Controls 

As mentioned above, one feature of the invention is to 
allow the user to programmatically set the control to any 
valid date, retrieve the current date and format i.e order, &e 
current date through a public interface. One preferred 
embodiment of the public interfaces of date control C++ 
class is shown below. 



public: 

UIFWDatoCcDtn7l (uoisgned long uHid, 
rWLodcw ♦piwPaitnt, 

IWindow *piwOwner); 

UIFWDateCoDtioI 
&setDatc(caast IDate& idDefault); 

UIFWDatoCanlrol &aelFickILabels(coQst IRcsouiceia& iriMonttiLabcl, 
const ]Re90urceId& iriDayLabel, 
const lRe90uiceId& iriYeuLabcl); 
UIFWDatoCQDtro} &aetFiekSLabcIs(coost char 
•psiMoiitliUl)el=''Month", 

const char *pazDayI-abcl=^ay", 
const char ♦p62yeaiLabel=^cai"); 

IDate 

gctDateO const; 
IStriog 

jctDateAsStjingO coast; 

iiroignrrf sbcrl getDatcOiderO const; 

mFWDateCcDtiol &setDateOrdcr(uiisigiied sboit usOrdcr); 

IMuldCeUCanvas & mabkCBookan euablcWiiiidDW =tiue); 

IMumCeUCanvas ftdisablcQ; 



In the preferred embodiment, the interfaces of tiie date 
control can be used in several ways. In the application, an 
Instance of the date control would be created by invoking the 
class constructor UIFWDateControl. This constructor 
requires that an arbitrary identiiicr be supplied^ as wcU as 
pointers to the parent and owner windows. 

A default value of the date control could be set in the 
application by invoking the setDate method on the new 
instance. For convenience in the preferred environment, the 
setDate method takes as its input an instance of the IDate 
class. The IDate class is provided by IBM Open Class as a 
means of organizing date data into a convenient structure. 
However, one skilled in the art could create a similar data 
structure which consists of three unsigned short integers 
which represent the month, day, and year values of a date. 
Hic setDate method updates the value of each spin button to 
reflect the date desired. Additionally, the range of the day 
spin button is set based on what is valid for the month. 

The application overrides the default date order dictated 
by available locale information and instead sets the date 
order arbitrarily. An oveixide could be accon^lished by 
invoking the setDateOrder method on die date control 
insunce. The setDateOrder method takes as input an 
unsigned short integer with the following meaning. A value 
of 0 indicates that the date order should be set to Month, 
Day, Year. A value of 1 indicates that the date order should 
be set to Day, Month, Year. A value of 2 indicates that the 
date order should be set to Year, Month, Day. Any other 
value defaults to Month, Day, Year. 

After some amount of user interaction, the application can 
retrieve the current value of the date control. It is necessary 
to retrieve the current value of the date control to store the 
value in a database or use the value as input to some other 



processing, for example. A GUI used for tracking records, 
for example, may need to store the date of documents in a 
database. To retrieve the current value, the getDate method 
would be invoked on die date control instance. The getDate 
method in turn retrieves the values from each of die spin 
buttons via methods that each spin button should provide. 
For convenience sake, the getDate method returns the cur- 
rent value of the control as an instance of the IDate class, 
however, as mentioned above, another structure can easily 
be used. 

The application may also retrieve the value of the date 
control as a character string. The gctDateAsString method 
can be used for this purpose. The getDateAsString method 
is invoked on the date control instance. This method makes 
use of the getDate method to retrieve the date value from the 

15 control as an IDate construct and then converts it to a 
character string before it is returned to the application. The 
format of the string is determined by country specific locale 
information if available, or defaults to the format mm/dd/yy. 
The application may also temporarily disable or enable 

20 the date control This is accon^>lished by invoking the 
enable or disable method on the date control instance. The 
disable method has the effect of visually "graying" all of the 
objects which together make up the date control These 
include each of the three spin buttons and their correspond- 

25 ing text labels, In addition to being visually grayed, the 
control is made inoperable, and therefore docs not respond 
to user interaction. The enable method has the effect of 
^iingraying" these objects and otherwise making the control 
operable again. 

As discussed above, the preferred embodiment of the 
invention provides a public interface for the time control to 
set the control to any valid time, retrieve the time value from 
the control, format the value of the time control to a 
culturally correct string and enable ch* disable the time 
control. One preferred embodiment of the pubUc interfaces 

35 of this new time control dass is shown below. 



pubUc: 



In the preferred embodiiueot, an application could use the 
interfaces of the time control in the following ways. First, as 

60 above, an instance of the time control is created by invoking 
the class constructor UIFWTimeControl The application 
could set the default value of the time control by invoking 
the scfTime method on the new instance. For convenience in 
the prefcired environment, die setTimc method takes as its 

65 input an instance of the ITime class. The ITime class is 
provided by IBM Open Class as a means of organizing time 
data into a convenient structure. However, one skilled in the 
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UIFWTiiiieCoattol ( unisoged long uHd, 
IWindow •piwparent, 

IV^ndow ♦piwOwner); 

Un^WTuncCoatroI 

&scain»(coDst TTaocSt ifDcfoult); 
UIFWTunoCoatiol &sctFicldLabels(const IResouiceId& biHoursLabcl, 
const nUsourocIdfe iriMlmJtesLabcl, 
const Dte90urceld& iriSecosdsLabcl); 
UIFWTmuOootxol ftsetFieklLabeIs(oonst char *pszHourcLabel:^Hour3*', 
coDst char •pszMiDUtc^abct=''Minutc5", 
const char *pszSeco(ndd.abcl=^SocoDds'*); 
UIFWTimeOoatrol ftsctAMFMStrings (const IRe90urceId& iriAMString, 

const IRc90Uioeld& iriPNfStrxog); 
UIFWTiiDeCoatzul ftsetAMFMStrings (const char *pszAMStrin£=**ANr, 
coast char *pszPMStriiig+"PM"); 

ntmc 

geflbncO const; 
IString 

geflliDeAsStzuigO const; 
UIFWllaieCoatiol &sctIlineMode<UDsigDod short usModc); 
IMultiCellCanvas AcnablcCBoolean eoabkWiixbw - true); 
IMultiCcUCanvas ^disablcQ; 
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cIass_JExport UIFWDatcTunHindlcr public IHandlcr 
{ 

fncoA dass UIFWDateControl; 
friend class UIFWTimeCaDtroI; 
public: 

UIFWDateTmtfHaDdleiO: Constnictar 
UIFWDatcTuDcHandlcrO; /// Destructor 

protected: 
/kfcfine UIFWJ)T_CHANGED 1300 
Boolean di^atcUHaiuUeiEyeDtC lEveut & evt ); 
virtual Bookan cbansed(IC0Dtn3lEvent fticeCtlBveiit); 

yj// end class UIFWDateTlmeHaiidkr 



In the prefeired embodiment, the new handler class, 
UIFWDatcTimcHandlcr, is derived from a generic handler 
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ait could create a similar data structure which consists of 
three unsigned short integers which represent the hours, 
minutes, and seconds values of a time. The setTime method 
updates the value of each spin button to reflect the time 
desired, and if the time control is in 12 hour format, it selects 
the appropriate radio button as well. The time control could 
be used as an applciation dock, for example, wherein the 
time is reset periodically. 

The application may override the default time mode 
dictated by available locale information and instead set the 
time mode arbitrarily. The plication could do so by 
invoking the scdlmeMode method on the time control 
instance. The setTimeMode method takes as input an 
unsigned short integer with the following meaning. A value 
of 0 indicates that the time mode should be set to 24 horn- 
format A value of 1 indicates that the time mode should be 
set to 12 hour format Any other value defaults to 24 hour 
format 

After some amount of user interaction, the application 
may retrieve the current value of the time control To do so, 
the getrime method on the time control instance would be 
invoked. TTiis in turn retrieves the values from each of the 
spin buttons via methods that each spin button should 
provide, and if the time control is in 12 hour format, it 
queries the value of the radio buttons to return the appro- 
priate time value. For convenience sake, the getTimc mcdiod 
returns the current value of the control as an instance of the 
rrime class, however, as mentioned above, another stracture 
can easily be used. 

The application may also retrieve the value of the time 
control as a character string. The gefTimeAsString method 
can be used for this purpose. This method is invoked on the 
time control instance. This method makes use of the getTime 
method to retrieve the time value from the control as an 
inme construct and then converts it to a character string 
before it is returned to the programmer. The format of the 
string is determined by country specific locale infonnation if 
available, or defaults to the format hh3nm:ss. 

The application may temporarily disable or enable the 40 
time control This is acoon^lished by invoking the enable or 
disable method on the time control instance. The disable 
method has the effect of visually "graying" all of the objects 
which together make up the time control These include each 
of the three spin buttons, their corresponding text labels, and 45 
if the control is in 12 hour format, radio buttons. In addition 
to being visually grayed, the control is made inoperable, and 
therefore docs not respond to user interaction. 

As discussed above, a handler dass has been derived 
whidi allows the date and time controls to send events to 
their owning windows. One preferred embodiment for the 
definition of this new handler C-H- class is shown below: 



class, IHandlcr, indudcd in IBM Open Class. An application 
which listens for the new event, mFW_J3T_CHANGED, 
would have a subdassed handler instance using attached to 
the owner of the control to be monitcH-ed, via the han- 
dlcEvcntsFor method. The handleEventsFor method is pro- 
vided by the IHandler class and serves to connect a handler 
to any object derived from the IWindow dass. One of the 
methods overridden for the current invention is the dispatch- 
HandlerEvent The overridden method of the UIFWDa- 
teTimeHandlcr class filters all messages looking for the new 
event, UIFW„DT_CHANGED. When this event is 
received, another method is invoked to perform any pro- 
cessing that should occur when the event happens. 

WhUc the invention has been shown and described with 
reference to particular embodiments thereof, it will be 
understood by those skUled in the art that the invention can 
be practiced, with modification, in other environments. For 
example, although the invention described above can be 
conveniently implemented in a general purpose computer 
selectivdy reconfigured or activated by software, those 
skilled in the art would recognize fiiat the invention could be 
carried out in hardware, in firmware or in any combination 
of software, firmware or hardware induding a spedal pur- 
pose apparatus specifically designed to perform the 
described invention. Further, although numerous references 
25 have been made to specific objects and methods and modi- 
fications thereof, one skilled in the art would appreciate that 
other objects and methods could be easily substituted. 

TherefOTe, changes in form and detail may be made 
therein without departing from the spirit and scope of the 
30 invention as set forth in the accompanying claims. 
Wc claim: 

1. A method for operating an object oriented control in a 
gr^hical user interface of a oonq)uter system, wherein the 
control is conq)osed of plurality of child objects, con^nising 
the steps of; 

determining a value for a first child object in the control; 
setting a range of allowed values in a second child object 

according to the value for the first child object; 
monitoring the values selected by a user for the second 
child object; 

responsive to a sdection beyond a first end of the allowed 
range of values for the second child object, selecting a 
value for the second diild object at a second end of the 
allowed range of values for the second child object; and 
responsive to selecting the value at the second end of the 
allowed range, dianglng the value for the first diild 
object. 

2. The method as recited in daim 1 wherein the control is 
a date control and the first child object is for setting a month 
value and the second child object is for setting a day value. 

3. The method as redted in daim 1 further con^irises the 
step of; 

rejecting any sdected values outside the range of allowed 
values for the second child object 

4. The method as redted in daim 2 further conqirishig the 
steps of: 

detecting a change in the month value for the first child 
object; 

detemining a new allowed range for the day value of the 

second diild object; and 
determining whether a current day value for the second 
child object is outside the new allowed range. 

5. The method as redted in daim 2 wherein the control 
further comprises a third child object for setting a year value, 
and the naethod fiirther conq>riscs the steps of: 

determining a date order for an application which owns 
the control; and 
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ordering the first, second and tliird child objects within the 
control according to the date order. 

6. The method as recited in claim 5 wherein the date order 
is determined from a locale value for the owning application 
by accessing a data structure containing locale and corre- 
sponding date order data. 

7. The method as rcdtcd in claim 5 wherein the date order 
is determined according to a default value for the owning 
application. 

8. The method as recited in claim 1 further comprising the 
steps of: 

detecting a change in the first diild object of the control; 
and 

notifying an application which owns the control of the 
detected diange with a message comprising an identi- 
fier for the control and detected diange in the first child 
object. 

9. A system including processor, memory, input device 
and display for operating an object oriented control in a 
graphical user intofacc of a computer system, wherein the 
control is composed of plurality of child objects, compris- 
ing: 

means for determining a value for a first child object in the 
control; 

means fos^ setting a range of allowed values in a second 
child object according to the value for the first child 
object; 

means for monitoring the values selected by a user for the 
second child object; 

means responsive to a selection beyond a first end of the 
allowed range of values for the second child object for 
selecting a value for the second child object at a second 
end of the allowed range of values for the second child 
object; and 

means responsive to selecting the value at the second end 
of the allowed range for changing the value for the first 
child object. 

10. The system as recited in claim 9 wherein the control 
is a date control and the first diild object is for setting a 
month value and the second child object is for setting a day 
value. 

11. The system as recited in daim 9 further conq)rises 
means fcr rejecting any selected values outside the range of 
allowed values for the second child object. 

12. The system as recited in claim 10 further comprising: 
means for detecting a change in the month value for the 

first child object; 
means for determining a new allowed range for the day 

value of the second child object; and 
means for determining whether a current day value for the 

second child object Is outside the new allowed range. 

13. The system as recited in claim 11 wherein the control 
further comprises a third child object for setting a year value, 
and the system further co^^7Iises: 

means for determining a date order for an application 

whidi owns the control; and 
means for ordering the first, second and third child objects 

within the control according to the date order. 

14. The system as recited in claim 13 wherein the date ^ 
order is determined from a locale value for the owning 
plication by accessing a data structure containing locale 
and conesponding date order data. 

15. The system as recited in claim 13 wherein the date 
order is determined according to a default value for the 
owning application. 
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16. The system as recited in daim 9 further comprising: 
means for detecting a change In the first child object of the 

control; and 

means for notifying an application which owns the control 
of the detected change with a message comprising an 
identifier for the control and detected change in the first 
child object 

17. A computer program product in a computer readable 
memory for operating an object oriented control in a graphi- 
cal user interface of a co!xq)uter system, wherein the control 
is composed of plurality of diild objects, comprising: 

means for determining a value for a first child object in the 
control; 

means for setting a range of allowed values in a second 
child object acct^ding to the value for the first child 
object; 

means for monitoring the values selected by a user for the 
second child object; 

means responsive to a selection beyond a first end of the 
allowed range of values for the second child object for 
selecting a value for the second child object at a second 
end of the allowed range of values for the second child 
object; and 

means responsive to sdecting the value at the second end 
of the allowed range for changing the value for the first 
child object 

18. The jfffoduct as redted in claim 17 wherein the control 
is a date control and the first child object is for setting a 
month value and the second child object is for setting a day 
value. 

19. Hie product as redted in daim 17 fiirthcr comprises 
means for rejecting any sdected values outside the range of 
allowed values for the second child object. 

20. The product as redted in daim 18 further comprising: 
means for detecting a change in the month value for the 

first child object; 
means for detomining a new allowed range for the day 

value of the second child object; and 
means for determining whether a current day value for the 

second diOd object is outside the new allowed range. 

21. The product as redted in claim 19 wherdn the control 
further comprises a third chUd object for setting a year value, 
and the product fiirthcr comprises: 

means for determining a date order for an application 

which owns the control; and 
means for ordering die first, second and third diild objects 

within the control according to tiie date order. 

22. The product as redted in daim 21 wherein the date 
order is ddcrmined firom a locale value for the owning 
application by accessing a data structure containing locale 
and corresponding date order data. 

23. The product as redted in claim 21 wherein the date 
order is determined according to a default value for the 
owning application. 

24. The product as redted in claim 17 further comprising: 
means for detecting a change in the first child object of the 

control; and 

means for notifying an application which owns the control 
of the detected change with a message comprising an 
identifier for the control and detected change in the first 
child object 
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